1 MACX

MACX lets you upload Macintosh files to the VAX and download Macintosh files
from the VAX.  The files can be of any type, including MacPaint pictures,
formatted MacWrite files, fonts, and applications.

To use MACX, you MUST be running MacTerminal (you can't use any other
terminal program), and your file transfer settings must be:

	Transfer Method   (*) XMODEM        ( ) Text
	Remote System     (*) MacTerminal   ( ) Other

The other settings don't matter.  Notice that you set "remote system" to
"MacTerminal" even though the remote system is really a VAX.

MACX commands can be abbreviated to one character.  C)atalog will show you
what files are available.  The main commands are C)atalog, U)pload, D)ownload,
and Q)uit.  Special commands are available for text files.
2 Catalog

C)atalog shows you what Macintosh files are available.

Notice that every Macintosh file has TWO NAMES: a Macintosh name and a VMS
name.  The Macintosh name is the name the file had or will have on the 
Macintosh; the VMS name is the name it has on the VMS system.  The Macintosh
name is for information only.  In MACX commands, you must ALWAYS use the
VMS name.

Advanced users: VMS filenames for Macintosh files have a default ".MAC"
extension.  The Catalog command can be followed by an optional directory
specification.
2 Download

To download a file, use the D command followed by the VMS name (NOT the
Macintosh name) of the file you want.  For example:

VMS name   Macintosh file       Type             Size  Last modified
 
BACKGAMN   Backgammon           Application       31K   9-DEC-1984 08:24:21
CALENDAR   calendar             Application       23K  25-AUG-1984 17:44:34

to download the Backgammon application, you would use the command

	MACX>d backgamn

MACX will automatically trigger MacTerminal to receive the file; you do not
need to pull down any MacTerminal commands.
2 Upload

To upload a file, use the U command.  If you use U by itself, MACX will
automatically name the VMS file by taking the first 9 alphanumeric
characters in the Macintosh file name.  If you want to choose the VMS
file name yourself, type it after the U:

	MACX>u myname

VMS file names are limited to 9 characters which must be letter or numerals.
You may NOT use spaces or punctuation in a VMS file name.

After issuing the U)pload command, you must then tell MacTerminal to send
the file by pulling down "Send file..." from the File menu.
2 Text
Many Macintosh applications produce "TEXT" documents; for example, MacWrite
if you save "Text only."  Macintosh "TEXT" documents are fairly easy to
exchange with other computer systems.

Suppose that "TEXTDOC.MAC" is the VMS file name of a Macintosh text document.
You cannot use TEXTDOC.MAC directly under VMS; although it is stored in the
VMS system, it is not stored in the normal VMS text format, but in a format
the mirrors the Macintosh format.  For example, you could not meaningfully
edit TEXTDOC.MAC with EDT or TECO.  MACX does, however, provide tools for
converting Macintosh text format to and from VMS text format.

The tools are TYPE, PRINT, IMPORT, EXPORT; these commands can be abbreviated
to their initial character if desired. In addition, UPLOAD/TEXT and 
DOWNLOAD/TEXT provide direct Mac-to-VMS text uploads and downloads.
3 Type
The MACX command

	MACX>TYPE TEXTDOC

will display TEXTDOC on the screen.  TEXTDOC must be a Macintosh text file
appearing in the MACX catalog; that is, it must have a VMS ".MAC" extension
and a Macintosh "TEXT" type.

Lines exceeding 79 characters will be wrapped.  The wrap length can be
changed by including a /WRAP qualifier; for example,

	MACX>TYPE TEXTDOC/WRAP=72
3 Print
The MACX command

	MACX>PRINT TEXTDOC

will print TEXTDOC on the system printer.  TEXTDOC must be a Macintosh
text file appearing in the MACX catalog; that is, it must have a VMS ".MAC"
extension and a Macintosh "TEXT" type.

Lines exceeding 79 characters will be wrapped.  The wrap length can be
changed by including a /WRAP qualifier; for example,

	MACX>PRINT TEXTDOC/WRAP=72

Printers other than the system printer can be specified with the /OUT
qualifier; for example,

	MACX>PRINT TEXTDOC/OUT=QUME:
3 Import
3 Export
3 Upload
	MACX>UPLOAD filename.ext/TEXT		performs a "text upload."

a) The file you send must be a Macintosh text file.  Examples of text files
are: MacWrite files you save using the "TEXT ONLY" option; MacTerminal
documents; files produced by MockWrite or captured by MockTerminal; and 
MS-BASIC programs that have been saved with the TEXT option.

b) "filename.ext" should be a full VMS filename with extension; for example,
"note.txt".  Do NOT use the extension ".mac".

c) You should use the normal MACX file transfer settings: XMODEM/MacTerminal.
Do NOT use any other settings.

d) When the transfer is complete, the file will NOT appear in the MACX
catalog.  It will appear in the normal VMS directory with the filename and
extension you specified, and can be handled as a normal VMS text file.

3 Download
	MACX>DOWNLOAD filename.ext/TEXT		performs a "text download."

a) "filename.ext" should be a full VMS filename with extension; for example,
"note.txt" or "letter.rno".  The file must be a normal VMS text file, one
that you could edit with EDT or type out with TYPE.  These files will NOT
appear in a MACX catalog.

b) You should use the normal MACX file transfer settings: XMODEM/MacTerminal.
Do NOT use any other settings.

c) The downloaded file will appear on your Macintosh as a MacWrite TEXT
file.
